在原生iOS或Android应用中将Unity作为库使用

Unity 2019.3将添加支持，可以将Unity作为原生Android/Java和iOS/Objective C应用控制的库，以便轻松加入AR和其它Unity功能。

在一些情况下，使用Android/Java和iOS/Objective C等原生平台技术的开发者可能希望在应用或游戏中加入Unity提供的功能，通常用于3D或2D实时渲染。

从Unity 2019.3.a2开始，我们通过把Unity运行时组件和内容集成到原生平台项目，在原生应用中将Unity作为库使用。Unity Runtime Library公开了控制功能，从而在原生应用中管理加载、激活和卸载的时间和方式。

这意味着开发者可以将Unity所能实现的增强现实AR、3D/2D实时渲染、2D迷你游戏等功能，直接添加到自己的原生移动应用。

请注意：将Unity作为库使用，要求开发者对Android/Java和iOS/Objective C的架构有着深入的了解。

限制

我们测试了很多种将Unity作为库并由原生应用托管的情况，但由于Unity不再控制运行时的生命周期，因此我们无法确保它可以在所有用例都正常工作，例如：

• 作为库使用的Unity仅支持全屏渲染，不支持在屏幕的一部分进行渲染。

• 不支持加载多个Unity运行时实例。

• 开发者需要调整第三方插件，包括原生插件和托管插件，从而让它们正常工作。

项目结构改变

Unity运行时库会公开控制功能，以管理在原生应用中加载，激活和卸载的时间和方式。移动应用的构建过程总体上依旧相同，Unity将创建iOS Xcode和Android Gradle项目。

为了启用该功能，我们修改了生成iOS Xcode和Android Gradle项目的结构，结构如下：

• 库：iOS框架和Android Archive（AAR）文件，包含所有源文件和插件。

• 精简的启动器：包含应用程序展示数据，它会运行库部分。

我们将在后续文章中，提供关于如何把iOS / Android库部分加入到原生应用程序的分步讲解。下面介绍Xcode项目和Android Gradle项目的变化。

iOS

主要功能围绕Xcode项目展开，以获得名为UnityFramework的额外目标。此目标包括源/插件和依赖框架，并生成UnityFramework.framework文件。启动屏幕，Xib，图标，数据等保留在Unity-iPhone目标中。Unity-iPhone目标将对UnityFramework目标具有单一依赖性。

UnityFramework提供简单的API来管理播放器从本机端加载/卸载，在需要时暂停/取消暂停，向游戏对象发送消息并设置播放器数据文件夹所在的捆绑包，这样就可以在一个地方拥有Unity播放器需要运行的所有框架文件。

改变

将Unity作为库的功能对API和Xcode项目结构带来了一些变化。

对于大多数用例而言，所有内容会和原先一样工作，但如果你开发或使用插件、自定义BuildPostProcessor、PBXProject和CI，即使在开发者没有将Unity作为库使用，这些变化也可能会影响项目。

1

 PBXProject 

PBXProject.GetUnityTargetName和pbxProject->TargetGuidByName(“Unity-iPhone”)都已经被弃用。

我们改为使用pbxProject->GetUnityFrameworkTargetGuid()，它用于源代码、插件、依赖框架和源代码构建选项，或使用pbxProject->GetUnityMainTargetGuid()。使用已弃用函数会遇到异常。

// 下面代码已被弃用

string targetGuid = proj.TargetGuidByName("Unity-iPhone");

string targetGuid = proj.TargetGuidByName(PBXProject.GetUnityTargetName());

// 请改为调用下面二个代码之一

string targetGuid = proj.GetUnityFrameworkTargetGuid();

string targetGuid = proj.GetUnityMainTargetGuid();

如何在资源包或自定义后处理程序中，同时支持旧的和新的代码路径？

• 在允许情况下使用插件导入器功能，例如：指定额外框架。

• 使用反射。

string mainTargetGuid;

string unityFrameworkTargetGuid;

var unityMainTargetGuidMethod = proj.GetType().GetMethod("GetUnityMainTargetGuid");

var unityFrameworkTargetGuidMethod = proj.GetType().GetMethod("GetUnityFrameworkTargetGuid");

if (unityMainTargetGuidMethod != null && unityFrameworkTargetGuidMethod != null)

{

    mainTargetGuid = (string)unityMainTargetGuidMethod.Invoke(proj, null);

    unityFrameworkTargetGuid = (string)unityFrameworkTargetGuidMethod.Invoke(proj, null);

}

else

{

    mainTargetGuid = proj.TargetGuidByName ("Unity-iPhone");

    unityFrameworkTargetGuid = mainTargetGuid;

}

2

ProjectCapabilityManager 

ProjectCapabilityManager现在会接收目标的全局唯一标识符GUID。

3

xcodebuild 

一些构建设置拥有后缀来指定确切目标，这些后缀有：*_APP表示应用目标，*_FRAMEWORK表示框架目标。

在构建xcodebuild时，这样使用加入后缀的版本：

PRODUCT_NAME -> PRODUCT_NAME_APP

PROVISIONING_PROFILE -> PROVISIONING_PROFILE_APP

PROVISIONING_PROFILE_SPECIFIER  -> PROVISIONING_PROFILE_SPECIFIER_APP

OTHER_LDFLAGS -> OTHER_LDFLAGS_FRAMEWORK

示例

将Unity作为库集成到原生iOS应用的示例，请参考：

https://forum.unity.com/threads/integration-unity-as-a-library-in-native-ios-app.685219/

Android

如果使用Unity作为库，Android Gradle项目的结构会发生改变。如果使用自定义mainTemplate.gradle或AndroidManifest.xml，这些改变也会影响项目或Unity插件。

此前，Unity会使用单个Gradle模块来构建Android应用。现在，Unity会使用二个模块创建Gradle项目，即：unityLibrary模块和启动器模块。

改变

unityLibrary模块包含Unity运行时和项目数据。该模块是一个可以轻松集成到任何其它Gradle项目中的库，也可以把Unity嵌入到现有原生Android项目中。

启动器模块包含所有图标和应用名称，它是一个简单的Android应用程序，可以启动Unity。

1

Gradle项目结构

将Unity作为库会提供新的Gradle项目结构，它会更好的符合Android Studio项目最佳结构。该结构中有一个根文件夹，其中包含一些可以单独构建和使用的子项目。它让导入Unity Android Studio项目更加简单。

2

Gradle模板工作流程

Gradle模板会描述和配置使用Gradle构建Android应用的方法。每个Gradle模板代表一个Gradle项目，Gradle项目可以包括和依赖其它Gradle项目。

将Unity作为库的Gradle模板文件如下：

• baseProjectTemplate.gradle：包含所有其它模板和Gradle项目共享的配置，即Android Gradle插件上的代码库和依赖。

• launcherTemplate.gradle：包含如何构建Android应用的指令，例如：打包，签名和APK分离等，具体取决于unityLibrary项目，它会输出一个APK文件或App Bundle。

• mainTemplate.gradle：包含如何把Unity构建为库的指令，它会输出.aar格式文件，用户可以提供自定义模板来重写Unity模板，包括编辑器设置。

• libTemplate.gradle：与之前的工作方式相同。

3

清单工作流程

将Unity作为库会改变Unity Android应用清单文件的使用方式。此前会有一个AndroidManifest.xml文件，用于给Android应用提供图标、行为、权限和其它设置。

使用新系统后，我们有二个清单文件，而不是一个：

• LauncherManifest.xml：负责处理图标、应用名称、开始行为及其目的、安装位置、支持的屏幕大小和设置“isGame”。

• LibraryManifest.xml：负责声明Unity行为、权限、Unity行为使用的主题、VR模式、VR性能、使行为不可以调整大小、设置最大高宽比、应对配置改动、朝向、启动模式、Android UI硬件加速、使用的功能，例如游戏手柄或图形API和槽口支持。

  该清单文件可以通过在Plugins/Android文件夹中提供自定义AndroidManifest.xml文件来重写。

示例

将Unity作为库集成到原生Android应用的示例，请参考：

https://forum.unity.com/threads/integration-unity-as-a-library-in-native-android-app.685240/

推动改变营销的技术

作为库的Unity可以为不同行业的各种用例提供巨大优势，品牌和创意公司可以轻松地把AR直接加入原生移动应用。

前沿品牌会看到添加AR到传统营销活动的价值，由于Unity支持把Unity用作库，因此添加过程会得到简化。品牌和创意公司不再需要重新构建应用以加入AR功能，或自己开发解决方案来把Unity用作库。

消费者已经准备好迎接AR营销，AR让品牌和消费者建立起个人关系，我们很高兴提供推动营销发展的解决方案。

了解品牌和创意公司如何使用Unity，请访问Unity解决方案网站：

https://unity.com/solutions/brands-and-creative-agencies

更多Unity最新信息，请关注Unity Connect平台(Connect.unity.com）下载Unity Connect APP，请点击此处。 观看部分Unity官方视频，请关注B站帐户：Unity官方。

推荐阅读

点个“在看”，表达你的态度